Skip to content

docs: add Windows/XAMPP installation guide and Windows path examples#410

Open
reyruiz1 wants to merge 1 commit into
TestLinkOpenSourceTRMS:testlink_1_9_20_fixedfrom
reyruiz1:testlink_1_9_20_fixed
Open

docs: add Windows/XAMPP installation guide and Windows path examples#410
reyruiz1 wants to merge 1 commit into
TestLinkOpenSourceTRMS:testlink_1_9_20_fixedfrom
reyruiz1:testlink_1_9_20_fixed

Conversation

@reyruiz1
Copy link
Copy Markdown

Summary

  • Add INSTALL_WINDOWS.md: step-by-step installation guide for Windows/XAMPP
    covering PHP 8.x + MySQL 8.0, required directories, phpMyAdmin setup, and
    troubleshooting for common errors encountered on Windows installs
  • Update custom_config.inc.php.example: add Windows path examples alongside
    existing Linux examples so Windows users know what values to use
  • Update .gitignore: exclude .claude/ (Claude Code AI tool session files)

Motivation

The existing documentation only shows Linux paths (/var/testlink/logs/).
Windows users following a fresh XAMPP install hit multiple errors with no
guidance. This PR documents the working solution tested on Windows 11 + XAMPP.

Errors covered in the troubleshooting section

  • /var/testlink/logs/ directory not found (Unix path used on Windows)
  • 1045 Access denied for testlinkUser (password out of sync after failed install)
  • phpMyAdmin configuration storage not set up (pma user missing)
  • #1194 Table 'db' is marked as crashed
  • #1396 Operation ALTER USER failed (user doesn't exist)

- Add INSTALL_WINDOWS.md with step-by-step guide for PHP 8.x + MySQL 8.0
  on Windows using XAMPP, including troubleshooting for common install errors
- Add Windows path examples to custom_config.inc.php.example alongside
  existing Linux examples

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant